From d22c91127f185c5572f05043570aba158dc43af5 Mon Sep 17 00:00:00 2001
From: Alexander Larsson <alexl@redhat.com>
Date: Sun, 22 Oct 2017 22:57:55 +0200
Subject: [PATCH] gtk_image_get_surface: Add docs

---
 gtk/gtkimage.c | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/gtk/gtkimage.c b/gtk/gtkimage.c
index ac9f3473ff..d0e65f74bf 100644
--- a/gtk/gtkimage.c
+++ b/gtk/gtkimage.c
@@ -1087,6 +1087,20 @@ gtk_image_get_pixbuf (GtkImage *image)
   return _gtk_icon_helper_peek_pixbuf (&priv->icon_helper);
 }
 
+/**
+ * gtk_image_get_surface:
+ * @image: a #GtkImage
+ *
+ * Gets the image #cairo_surface_t being displayed by the #GtkImage.
+ * The storage type of the image must be %GTK_IMAGE_EMPTY or
+ * %GTK_IMAGE_SURFACE (see gtk_image_get_storage_type()).
+ * The caller of this function does not own a reference to the
+ * returned surface.
+ * 
+ * Returns: (nullable) (transfer none): the displayed surface, or %NULL if
+ *   the image is empty
+ * Since: 3.94.0
+ **/
 cairo_surface_t *
 gtk_image_get_surface (GtkImage *image)
 {
-- 
2.30.2